BBS in a Box 5

home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 5 / BBS in a Box -Volume V (BBS in a Box) (April 1992).iso / Files / Util / I-Im / Icon CZ.cpt / Source Code ƒ / 68K-Macros.asm next >
MacBinary | 1989-02-16 | 9.9 KB | [TEXT/EDIT]
open in:
MacOS 8.1 extracted |
Win98 extracted |
DOS extracted
view JSON data |
view as text

This file was processed as: MacBinary (archive/macBinary).

You can browse this item here: 68K-Macros.asm
Confidence	Program	Detection	Match Type	Support
`10%`	dexvert	MacBinary `(archive/macBinary)`	fallback	Supported
`1%`	dexvert	Text File `(text/txt)`	fallback	Supported
`100%`	file	MacBinary II, inited, Wed Feb 15 23:39:38 1989, modified Wed Feb 15 23:39:38 1989, creator Macintosh Edit, type ASCII, 9454 bytes "68K-Macros.asm" , at 0x256e 485 bytes resource	default (weak)
`99%`	file	data	default
`74%`	TrID	Macintosh plain text (MacBinary)	default
`25%`	TrID	MacBinary 2	default (weak)
`100%`	siegfried	fmt/1762 MacBinary (II)	default
`100%`	lsar	MacBinary	default
id metadata
key	value
macFileType	`[TEXT]`
macFileCreator	`[EDIT]`
hex view
+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 0e 36 38 4b 2d 4d 61 | 63 72 6f 73 2e 61 73 6d |..68K-Ma|cros.asm|
|00000010| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 54 45 58 54 45 44 49 | 54 01 00 00 00 00 00 00 |.TEXTEDI|T.......|
|00000050| 00 00 00 00 00 24 ee 00 | 00 01 e5 a0 20 01 0a a0 |.....$..|.... ...|
|00000060| 20 01 0a 00 00 00 00 00 | 00 00 00 00 00 00 00 00 | .......|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 95 23 00 00 |........|.....#..|
|00000080| 3b 09 09 09 2b 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |;...+---|--------|
|00000090| 2d 2d 2d 2d 2d 2d 2d 2d | 2b 0d 3b 09 09 09 7c 09 |--------|+.;...|.|
|000000a0| 09 20 20 20 20 7c 0d 3b | 09 09 09 7c 20 20 20 20 |.    |.;|...|    |
|000000b0| 20 36 38 4b 2d 4d 61 63 | 72 6f 73 20 20 20 20 7c | 68K-Mac|ros    ||
|000000c0| 0d 3b 09 09 09 7c 09 09 | 20 20 20 20 7c 0d 3b 09 |.;...|..|    |.;.|
|000000d0| 09 09 2b 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |..+-----|--------|
|000000e0| 2d 2d 2d 2d 2d 2d 2b 0d | 3b 0d 3b 20 36 38 4b 2d |------+.|;.; 68K-|
|000000f0| 4d 61 63 72 6f 73 20 2d | 20 6d 61 63 72 6f 73 20 |Macros -| macros |
|00000100| 74 6f 20 69 6d 70 72 6f | 76 65 20 6f 6e 20 74 68 |to impro|ve on th|
|00000110| 65 20 36 38 30 30 30 27 | 73 20 69 6e 73 74 72 75 |e 68000'|s instru|
|00000120| 63 74 69 6f 6e 20 6d 6e | 65 6d 6f 6e 69 63 73 2e |ction mn|emonics.|
|00000130| 0d 3b 0d 3b 09 25 57 25 | 5c 74 25 47 25 20 2d 20 |.;.;.%W%|\t%G% - |
|00000140| 53 43 43 53 20 49 6e 66 | 6f 0d 3b 0d 3b 20 20 20 |SCCS Inf|o.;.;   |
|00000150| 54 68 65 73 65 20 6d 61 | 63 72 6f 73 20 61 72 65 |These ma|cros are|
|00000160| 20 6d 6f 73 74 6c 79 20 | 69 6e 74 65 6e 64 65 64 | mostly |intended|
|00000170| 20 74 6f 20 61 75 67 6d | 65 6e 74 20 74 68 65 20 | to augm|ent the |
|00000180| 36 38 30 30 30 20 69 6e | 73 74 72 75 63 74 69 6f |68000 in|structio|
|00000190| 6e 20 73 65 74 2e 0d 3b | 20 53 6f 6d 65 2c 20 6c |n set..;| Some, l|
|000001a0| 69 6b 65 20 22 63 6f 6d | 70 61 72 65 22 2c 20 73 |ike "com|pare", s|
|000001b0| 69 6d 70 6c 79 20 72 65 | 76 65 72 73 65 20 74 68 |imply re|verse th|
|000001c0| 65 20 61 72 67 75 6d 65 | 6e 74 73 20 74 6f 20 6d |e argume|nts to m|
|000001d0| 61 6b 65 20 69 74 20 65 | 61 73 69 65 72 20 74 6f |ake it e|asier to|
|000001e0| 0d 3b 20 75 6e 64 65 72 | 73 74 61 6e 64 2e 20 20 |.; under|stand.  |
|000001f0| 4f 74 68 65 72 73 20 66 | 61 63 69 6c 69 74 61 74 |Others f|acilitat|
|00000200| 65 20 63 72 65 61 74 69 | 6f 6e 20 6f 66 20 73 74 |e creati|on of st|
|00000210| 72 75 63 74 75 72 65 64 | 20 63 6f 64 65 2e 0d 3b |ructured| code..;|
|00000220| 0d 3b 20 52 65 76 69 73 | 69 6f 6e 20 48 69 73 74 |.; Revis|ion Hist|
|00000230| 6f 72 79 3a 0d 3b 0d 3b | 20 38 38 30 36 3f 3f 20 |ory:.;.;| 8806?? |
|00000240| 20 20 52 50 4d 09 53 74 | 61 72 74 20 48 79 70 65 |  RPM.St|art Hype|
|00000250| 72 54 61 70 65 20 49 49 | 20 70 72 6f 6a 65 63 74 |rTape II| project|
|00000260| 2e 20 20 41 6c 6c 20 72 | 65 76 69 73 69 6f 6e 20 |.  All r|evision |
|00000270| 68 69 73 74 6f 72 79 20 | 66 6f 72 20 48 79 70 65 |history |for Hype|
|00000280| 72 54 61 70 65 0d 3b 09 | 09 49 49 20 69 73 20 73 |rTape.;.|.II is s|
|00000290| 74 6f 72 65 64 20 69 6e | 20 74 68 65 20 53 43 43 |tored in| the SCC|
|000002a0| 53 20 64 65 6c 74 61 20 | 63 6f 6d 6d 65 6e 74 20 |S delta |comment |
|000002b0| 6c 69 6e 65 73 2e 0d 0d | 3b 20 4d 61 63 72 6f 73 |lines...|; Macros|
|000002c0| 20 74 6f 20 6d 61 6b 65 | 20 74 68 65 20 22 63 6d | to make| the "cm|
|000002d0| 70 22 20 69 6e 73 74 72 | 75 63 74 69 6f 6e 20 6c |p" instr|uction l|
|000002e0| 6f 67 69 63 61 6c 20 62 | 79 20 75 6e 2d 72 65 76 |ogical b|y un-rev|
|000002f0| 65 72 73 69 6e 67 20 69 | 74 73 20 61 72 67 75 6d |ersing i|ts argum|
|00000300| 65 6e 74 73 2e 0d 3b 0d | 6d 61 63 72 6f 09 63 6f |ents..;.|macro.co|
|00000310| 6d 70 61 72 65 20 61 72 | 67 31 2c 61 72 67 32 20 |mpare ar|g1,arg2 |
|00000320| 3d 0d 09 63 6d 70 2e 77 | 20 7b 61 72 67 32 7d 2c |=..cmp.w| {arg2},|
|00000330| 7b 61 72 67 31 7d 0d 09 | 7c 0d 0d 6d 61 63 72 6f |{arg1}..||..macro|
|00000340| 09 63 6f 6d 70 61 72 65 | 5f 6c 20 61 72 67 31 2c |.compare|_l arg1,|
|00000350| 61 72 67 32 20 3d 0d 09 | 63 6d 70 2e 6c 20 7b 61 |arg2 =..|cmp.l {a|
|00000360| 72 67 32 7d 2c 7b 61 72 | 67 31 7d 0d 09 7c 0d 0d |rg2},{ar|g1}..|..|
|00000370| 6d 61 63 72 6f 09 63 6f | 6d 70 61 72 65 5f 62 20 |macro.co|mpare_b |
|00000380| 61 72 67 31 2c 61 72 67 | 32 20 3d 0d 09 63 6d 70 |arg1,arg|2 =..cmp|
|00000390| 2e 62 20 7b 61 72 67 32 | 7d 2c 7b 61 72 67 31 7d |.b {arg2|},{arg1}|
|000003a0| 0d 09 7c 0d 0d 3b 20 4c | 73 6c 20 61 6e 64 20 4c |..|..; L|sl and L|
|000003b0| 73 72 20 62 79 20 31 36 | 20 62 69 74 73 2c 20 61 |sr by 16| bits, a|
|000003c0| 20 63 6f 6d 6d 6f 6e 20 | 6f 70 65 72 61 74 69 6f | common |operatio|
|000003d0| 6e 2e 0d 3b 0d 6d 61 63 | 72 6f 09 6c 73 6c 5f 31 |n..;.mac|ro.lsl_1|
|000003e0| 36 20 61 72 67 31 20 3d | 0d 09 73 77 61 70 20 7b |6 arg1 =|..swap {|
|000003f0| 61 72 67 31 7d 0d 09 63 | 6c 72 20 7b 61 72 67 31 |arg1}..c|lr {arg1|
|00000400| 7d 0d 09 7c 0d 0d 6d 61 | 63 72 6f 09 6c 73 72 5f |}..|..ma|cro.lsr_|
|00000410| 31 36 20 61 72 67 31 20 | 3d 0d 09 63 6c 72 20 7b |16 arg1 |=..clr {|
|00000420| 61 72 67 31 7d 0d 09 73 | 77 61 70 20 7b 61 72 67 |arg1}..s|wap {arg|
|00000430| 31 7d 0d 09 7c 0d 0d 3b | 20 53 61 76 65 2f 72 65 |1}..|..;| Save/re|
|00000440| 73 74 6f 72 65 20 61 6c | 6c 20 72 65 67 69 73 74 |store al|l regist|
|00000450| 65 72 73 2c 20 61 6e 6f | 74 68 65 72 20 63 6f 6d |ers, ano|ther com|
|00000460| 6d 6f 6e 20 6f 70 65 72 | 61 74 69 6f 6e 0d 3b 0d |mon oper|ation.;.|
|00000470| 6d 61 63 72 6f 09 53 41 | 56 45 5f 41 4c 4c 20 3d |macro.SA|VE_ALL =|
|00000480| 0d 09 6d 6f 76 65 6d 2e | 6c 20 64 30 2d 64 37 2f |..movem.|l d0-d7/|
|00000490| 61 30 2d 61 34 2c 2d 28 | 73 70 29 0d 09 7c 0d 0d |a0-a4,-(|sp)..|..|
|000004a0| 6d 61 63 72 6f 09 52 45 | 53 54 4f 52 45 5f 41 4c |macro.RE|STORE_AL|
|000004b0| 4c 20 3d 0d 09 6d 6f 76 | 65 6d 2e 6c 20 28 73 70 |L =..mov|em.l (sp|
|000004c0| 29 2b 2c 64 30 2d 64 37 | 2f 61 30 2d 61 34 0d 09 |)+,d0-d7|/a0-a4..|
|000004d0| 7c 0d 0d 0d 6d 61 63 72 | 6f 09 5f 44 65 62 75 67 ||...macr|o._Debug|
|000004e0| 53 74 72 20 3d 0d 09 64 | 63 2e 77 20 24 61 62 66 |Str =..d|c.w $abf|
|000004f0| 66 0d 09 7c 0d 0d 3b 20 | 41 70 70 61 72 65 6e 74 |f..|..; |Apparent|
|00000500| 6c 79 2c 20 77 69 74 68 | 20 4d 44 53 20 32 2e 30 |ly, with| MDS 2.0|
|00000510| 20 74 68 65 20 63 6f 6e | 73 74 72 75 63 74 20 22 | the con|struct "|
|00000520| 70 65 61 20 27 4d 79 54 | 65 78 74 27 22 20 64 6f |pea 'MyT|ext'" do|
|00000530| 65 73 20 6e 6f 74 20 61 | 75 74 6f 6d 61 74 69 63 |es not a|utomatic|
|00000540| 61 6c 6c 79 0d 3b 20 64 | 65 63 6c 61 72 65 20 74 |ally.; d|eclare t|
|00000550| 68 65 20 74 65 78 74 20 | 61 6e 64 20 70 75 73 68 |he text |and push|
|00000560| 20 74 68 65 20 70 63 2d | 72 65 6c 61 74 69 76 65 | the pc-|relative|
|00000570| 20 61 64 64 72 65 73 73 | 20 74 68 65 20 77 61 79 | address| the way|
|00000580| 20 69 74 20 75 73 65 64 | 20 74 6f 20 69 6e 20 6f | it used| to in o|
|00000590| 6c 64 65 72 0d 3b 20 76 | 65 72 73 69 6f 6e 73 2e |lder.; v|ersions.|
|000005a0| 20 20 54 68 65 72 65 66 | 6f 72 65 2c 20 74 68 69 |  Theref|ore, thi|
|000005b0| 73 20 6d 61 63 72 6f 20 | 77 61 73 20 77 72 69 74 |s macro |was writ|
|000005c0| 74 65 6e 2e 20 20 49 74 | 20 64 65 63 6c 61 72 65 |ten.  It| declare|
|000005d0| 73 20 74 68 65 20 74 65 | 78 74 2c 20 6a 75 6d 70 |s the te|xt, jump|
|000005e0| 73 0d 3b 20 61 72 6f 75 | 6e 64 20 74 68 65 20 64 |s.; arou|nd the d|
|000005f0| 65 63 6c 61 72 61 74 69 | 6f 6e 2c 20 70 75 73 68 |eclarati|on, push|
|00000600| 65 73 20 74 68 65 20 61 | 64 64 72 65 73 73 2c 20 |es the a|ddress, |
|00000610| 61 6e 64 20 69 6e 76 6f | 6b 65 73 20 74 68 65 20 |and invo|kes the |
|00000620| 74 72 61 70 2e 0d 3b 0d | 49 46 20 44 42 55 47 0d |trap..;.|IF DBUG.|
|00000630| 6d 61 63 72 6f 09 44 45 | 42 55 47 53 54 52 20 74 |macro.DE|BUGSTR t|
|00000640| 65 78 74 20 3d 0d 09 62 | 72 61 2e 73 20 40 39 0d |ext =..b|ra.s @9.|
|00000650| 40 38 3a 0d 09 64 63 2e | 62 20 31 36 2c 7b 74 65 |@8:..dc.|b 16,{te|
|00000660| 78 74 7d 0d 09 64 63 2e | 62 20 33 32 2c 20 33 32 |xt}..dc.|b 32, 32|
|00000670| 2c 20 33 32 2c 20 33 32 | 2c 20 33 32 2c 20 33 32 |, 32, 32|, 32, 32|
|00000680| 2c 20 33 32 2c 20 33 32 | 0d 09 64 63 2e 62 20 33 |, 32, 32|..dc.b 3|
|00000690| 32 2c 20 33 32 2c 20 33 | 32 2c 20 33 32 2c 20 33 |2, 32, 3|2, 32, 3|
|000006a0| 32 2c 20 33 32 2c 20 33 | 32 2c 20 33 32 0d 09 2e |2, 32, 3|2, 32...|
|000006b0| 61 6c 69 67 6e 20 32 0d | 40 39 3a 0d 09 70 65 61 |align 2.|@9:..pea|
|000006c0| 20 40 38 0d 09 5f 44 65 | 62 75 67 53 74 72 0d 09 | @8.._De|bugStr..|
|000006d0| 7c 0d 45 4e 44 49 46 0d | 0d 3b 20 49 66 20 79 6f ||.ENDIF.|.; If yo|
|000006e0| 75 20 68 61 76 65 20 61 | 20 22 44 45 42 55 47 2e |u have a| "DEBUG.|
|000006f0| 53 54 52 22 20 6d 61 63 | 72 6f 2c 20 6a 75 73 74 |STR" mac|ro, just|
|00000700| 20 64 65 6c 65 74 65 20 | 74 68 65 20 22 44 22 20 | delete |the "D" |
|00000710| 74 6f 20 74 65 6d 70 6f | 72 61 72 69 6c 79 20 22 |to tempo|rarily "|
|00000720| 63 6f 6d 6d 65 6e 74 0d | 3b 20 69 74 20 6f 75 74 |comment.|; it out|
|00000730| 22 2e 20 20 4f 66 20 63 | 6f 75 72 73 65 2c 20 6f |".  Of c|ourse, o|
|00000740| 6e 63 65 20 64 65 62 75 | 67 67 69 6e 67 20 69 73 |nce debu|gging is|
|00000750| 20 63 6f 6d 70 6c 65 74 | 65 20 74 68 65 20 64 65 | complet|e the de|
|00000760| 62 75 67 67 69 6e 67 20 | 6d 61 63 72 6f 73 20 73 |bugging |macros s|
|00000770| 68 6f 75 6c 64 0d 3b 20 | 61 6c 6c 20 62 65 20 72 |hould.; |all be r|
|00000780| 65 6d 6f 76 65 64 20 66 | 72 6f 6d 20 74 68 65 20 |emoved f|rom the |
|00000790| 73 6f 75 72 63 65 2e 0d | 3b 0d 6d 61 63 72 6f 09 |source..|;.macro.|
|000007a0| 45 42 55 47 53 54 52 20 | 74 65 78 74 20 3d 0d 09 |EBUGSTR |text =..|
|000007b0| 3b 20 64 6f 65 73 20 6e | 6f 74 68 69 6e 67 0d 09 |; does n|othing..|
|000007c0| 7c 0d 0d 3b 20 4d 61 63 | 72 6f 73 20 66 6f 72 20 ||..; Mac|ros for |
|000007d0| 63 61 6c 6c 69 6e 67 20 | 74 68 65 20 64 65 62 75 |calling |the debu|
|000007e0| 67 4c 6f 67 32 20 73 75 | 62 72 6f 75 74 69 6e 65 |gLog2 su|broutine|
|000007f0| 2e 0d 3b 0d 49 46 20 44 | 42 55 47 0d 6d 61 63 72 |..;.IF D|BUG.macr|
|00000800| 6f 09 44 45 42 55 47 4c | 4f 47 20 76 61 6c 75 65 |o.DEBUGL|OG value|
|00000810| 20 3d 0d 09 6d 6f 76 65 | 09 7b 76 61 6c 75 65 7d | =..move|.{value}|
|00000820| 2c 2d 28 73 70 29 0d 09 | 62 73 72 09 64 65 62 75 |,-(sp)..|bsr.debu|
|00000830| 67 4c 6f 67 32 0d 09 7c | 0d 45 4e 44 49 46 0d 0d |gLog2..||.ENDIF..|
|00000840| 6d 61 63 72 6f 09 45 42 | 55 47 4c 4f 47 20 76 61 |macro.EB|UGLOG va|
|00000850| 6c 75 65 20 3d 0d 09 3b | 20 64 6f 65 73 20 6e 6f |lue =..;| does no|
|00000860| 74 68 69 6e 67 0d 09 7c | 0d 0d 3b 20 54 68 69 73 |thing..||..; This|
|00000870| 20 69 73 20 75 73 65 64 | 20 74 6f 20 69 6e 73 65 | is used| to inse|
|00000880| 72 74 20 68 75 6d 61 6e | 2d 72 65 61 64 61 62 6c |rt human|-readabl|
|00000890| 65 20 6c 61 62 65 6c 73 | 20 69 6e 20 63 6f 64 65 |e labels| in code|
|000008a0| 20 28 74 6f 20 6d 61 6b | 65 20 75 70 20 66 6f 72 | (to mak|e up for|
|000008b0| 20 74 68 65 0d 3b 20 66 | 61 63 74 20 74 68 61 74 | the.; f|act that|
|000008c0| 20 69 6e 20 61 73 73 65 | 6d 62 6c 65 72 20 79 6f | in asse|mbler yo|
|000008d0| 75 20 63 61 6e 27 74 20 | 63 72 65 61 74 65 20 6c |u can't |create l|
|000008e0| 61 62 65 6c 73 20 77 68 | 69 63 68 20 54 4d 4f 4e |abels wh|ich TMON|
|000008f0| 20 77 69 6c 6c 20 6e 6f | 74 69 63 65 29 2e 0d 3b | will no|tice)..;|
|00000900| 0d 49 46 20 44 42 55 47 | 0d 6d 61 63 72 6f 09 4c |.IF DBUG|.macro.L|
|00000910| 41 42 45 4c 20 74 65 78 | 74 20 3d 0d 09 64 63 2e |ABEL tex|t =..dc.|
|00000920| 62 20 27 3c 3c 27 0d 09 | 64 63 2e 62 20 7b 74 65 |b '<<'..|dc.b {te|
|00000930| 78 74 7d 0d 09 64 63 2e | 62 20 27 3e 3e 27 0d 09 |xt}..dc.|b '>>'..|
|00000940| 2e 61 6c 69 67 6e 20 32 | 0d 09 7c 0d 45 4c 53 45 |.align 2|..|.ELSE|
|00000950| 0d 6d 61 63 72 6f 09 4c | 41 42 45 4c 20 74 65 78 |.macro.L|ABEL tex|
|00000960| 74 20 3d 0d 09 3b 20 6e | 6f 74 68 69 6e 67 0d 09 |t =..; n|othing..|
|00000970| 7c 0d 45 4e 44 49 46 0d | 0d 3b 20 3d 3d 3d 3d 3d ||.ENDIF.|.; =====|
|00000980| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00000990| 20 4e 65 77 20 73 74 61 | 63 6b 2d 62 61 73 65 64 | New sta|ck-based|
|000009a0| 20 73 75 62 72 6f 75 74 | 69 6e 65 20 6d 61 63 72 | subrout|ine macr|
|000009b0| 6f 73 20 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |os =====|========|
|000009c0| 3d 3d 3d 3d 3d 3d 3d 3d | 0d 3b 0d 3b 20 54 68 65 |========|.;.; The|
|000009d0| 73 65 20 6d 61 63 72 6f | 73 20 6d 61 6b 65 20 69 |se macro|s make i|
|000009e0| 74 20 65 61 73 69 65 72 | 20 74 6f 20 69 6d 70 6c |t easier| to impl|
|000009f0| 65 6d 65 6e 74 20 73 74 | 61 63 6b 2d 62 61 73 65 |ement st|ack-base|
|00000a00| 64 20 73 75 62 72 6f 75 | 74 69 6e 65 73 20 61 6e |d subrou|tines an|
|00000a10| 64 0d 3b 20 66 75 6e 63 | 74 69 6f 6e 73 2c 20 75 |d.; func|tions, u|
|00000a20| 73 69 6e 67 20 41 70 70 | 6c 65 27 73 20 73 74 61 |sing App|le's sta|
|00000a30| 6e 64 61 72 64 20 73 74 | 61 63 6b 2d 62 61 73 65 |ndard st|ack-base|
|00000a40| 64 20 63 61 6c 6c 69 6e | 67 20 73 65 71 75 65 6e |d callin|g sequen|
|00000a50| 63 65 2e 20 20 54 68 65 | 79 20 73 61 76 65 0d 3b |ce.  The|y save.;|
|00000a60| 20 74 68 65 20 70 72 6f | 67 72 61 6d 6d 65 72 20 | the pro|grammer |
|00000a70| 66 72 6f 6d 20 68 61 76 | 69 6e 67 20 74 6f 20 74 |from hav|ing to t|
|00000a80| 68 69 6e 6b 20 61 62 6f | 75 74 20 68 6f 77 20 74 |hink abo|ut how t|
|00000a90| 68 65 20 66 72 61 6d 65 | 20 70 6f 69 6e 74 65 72 |he frame| pointer|
|00000aa0| 20 69 73 20 73 61 76 65 | 64 2c 20 73 65 74 0d 3b | is save|d, set.;|
|00000ab0| 20 75 70 2c 20 61 6e 64 | 20 72 65 73 74 6f 72 65 | up, and| restore|
|00000ac0| 64 2c 20 61 6e 64 20 66 | 72 6f 6d 20 68 61 76 69 |d, and f|rom havi|
|00000ad0| 6e 67 20 74 6f 20 66 69 | 67 75 72 65 20 6f 75 74 |ng to fi|gure out|
|00000ae0| 20 74 68 65 20 74 6f 74 | 61 6c 20 6c 65 6e 67 74 | the tot|al lengt|
|00000af0| 68 20 6f 66 20 74 68 65 | 20 6c 6f 63 61 6c 0d 3b |h of the| local.;|
|00000b00| 20 76 61 72 69 61 62 6c | 65 20 73 70 61 63 65 20 | variabl|e space |
|00000b10| 28 66 6f 72 20 75 73 65 | 20 69 6e 20 74 68 65 20 |(for use| in the |
|00000b20| 4c 49 4e 4b 20 69 6e 73 | 74 72 75 63 74 69 6f 6e |LINK ins|truction|
|00000b30| 2e 29 20 20 4c 6f 63 61 | 6c 73 20 61 6e 64 20 70 |.)  Loca|ls and p|
|00000b40| 61 72 61 6d 65 74 65 72 | 73 20 61 72 65 0d 3b 20 |arameter|s are.; |
|00000b50| 72 65 66 65 72 72 65 64 | 20 74 6f 20 61 73 20 6c |referred| to as l|
|00000b60| 6f 63 6c 5f 6e 61 6d 65 | 28 41 36 29 20 61 6e 64 |ocl_name|(A6) and|
|00000b70| 20 70 61 72 6d 5f 6e 61 | 6d 65 28 41 36 29 2c 20 | parm_na|me(A6), |
|00000b80| 72 65 73 70 65 63 74 69 | 76 65 6c 79 2e 20 20 54 |respecti|vely.  T|
|00000b90| 68 65 20 72 65 74 75 72 | 6e 0d 3b 20 76 61 6c 75 |he retur|n.; valu|
|00000ba0| 65 20 28 69 66 20 61 6e | 79 29 20 69 73 20 72 65 |e (if an|y) is re|
|00000bb0| 66 65 72 72 65 64 20 74 | 6f 20 62 79 20 28 41 36 |ferred t|o by (A6|
|00000bc0| 29 2e 0d 3b 20 20 20 20 | 54 68 65 73 65 20 6d 61 |)..;    |These ma|
|00000bd0| 63 72 6f 73 20 75 73 65 | 20 41 36 20 61 73 20 74 |cros use| A6 as t|
|00000be0| 68 65 20 70 61 72 61 6d | 65 74 65 72 20 66 72 61 |he param|eter fra|
|00000bf0| 6d 65 20 70 6f 69 6e 74 | 65 72 2c 20 61 6e 64 20 |me point|er, and |
|00000c00| 72 65 73 74 6f 72 65 20 | 69 74 73 20 76 61 6c 75 |restore |its valu|
|00000c10| 65 0d 3b 20 77 68 65 6e | 20 74 68 65 20 73 75 62 |e.; when| the sub|
|00000c20| 72 6f 75 74 69 6e 65 20 | 65 6e 64 73 2e 0d 3b 0d |routine |ends..;.|
|00000c30| 3b 20 20 20 57 68 65 6e | 20 61 20 73 75 62 72 6f |;   When| a subro|
|00000c40| 75 74 69 6e 65 20 69 73 | 20 63 61 6c 6c 65 64 20 |utine is| called |
|00000c50| 62 79 20 74 68 65 20 73 | 74 61 6e 64 61 72 64 20 |by the s|tandard |
|00000c60| 4d 61 63 20 50 61 73 63 | 61 6c 20 63 61 6c 6c 69 |Mac Pasc|al calli|
|00000c70| 6e 67 20 73 65 71 75 65 | 6e 63 65 2c 0d 3b 20 74 |ng seque|nce,.; t|
|00000c80| 68 65 20 73 74 61 63 6b | 20 6c 6f 6f 6b 73 20 73 |he stack| looks s|
|00000c90| 6f 6d 65 74 68 69 6e 67 | 20 6c 69 6b 65 20 74 68 |omething| like th|
|00000ca0| 69 73 3a 0d 3b 0d 3b 20 | 20 20 20 20 20 20 20 20 |is:.;.; |        |
|00000cb0| 20 20 20 20 53 50 0d 3b | 20 20 20 20 20 20 20 20 |    SP.;|        |
|00000cc0| 20 20 20 20 20 7c 0d 3b | 20 20 20 20 20 20 20 20 |     |.;|        |
|00000cd0| 2d 2d 2d 2d 2b 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |----+---|--------|
|00000ce0| 2b 2d 2d 2d 2d 2d 2b 2d | 2d 2d 2d 2d 2d 2d 2d 2d |+-----+-|--------|
|00000cf0| 2d 2d 2b 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2b 2d |--+-----|------+-|
|00000d00| 2d 2d 0d 3b 20 53 74 61 | 63 6b 20 67 72 6f 77 73 |--.; Sta|ck grows|
|00000d10| 7c 20 20 20 72 65 74 75 | 72 6e 20 20 7c 77 6f 72 ||   retu|rn  |wor|
|00000d20| 64 20 7c 20 20 20 6c 6f | 6e 67 20 20 20 20 7c 20 |d |   lo|ng    | |
|00000d30| 20 20 72 65 74 75 72 6e | 20 20 7c 20 68 69 67 68 |  return|  | high|
|00000d40| 65 72 0d 3b 3c 2d 2d 20 | 74 68 69 73 20 77 61 79 |er.;<-- |this way|
|00000d50| 7c 20 20 61 64 64 72 65 | 73 73 20 20 7c 70 61 72 ||  addre|ss  |par|
|00000d60| 61 6d 7c 20 20 20 70 61 | 72 61 6d 20 20 20 7c 20 |am|   pa|ram   | |
|00000d70| 20 20 76 61 6c 75 65 20 | 20 20 7c 20 6d 65 6d 6f |  value |  | memo|
|00000d80| 72 79 0d 3b 20 20 20 20 | 20 20 20 20 2d 2d 2d 2d |ry.;    |    ----|
|00000d90| 2b 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2b 2d 2d 2d |+-------|----+---|
|00000da0| 2d 2d 2b 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2b 2d |--+-----|------+-|
|00000db0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2b 2d 2d 2d 0d 3b |--------|--+---.;|
|00000dc0| 0d 3b 20 41 74 20 74 68 | 65 20 62 65 67 69 6e 6e |.; At th|e beginn|
|00000dd0| 69 6e 67 20 6f 66 20 79 | 6f 75 72 20 73 75 62 72 |ing of y|our subr|
|00000de0| 6f 75 74 69 6e 65 2c 20 | 75 73 65 20 74 68 65 20 |outine, |use the |
|00000df0| 53 54 41 43 4b 5f 44 45 | 43 4c 41 52 45 20 6d 61 |STACK_DE|CLARE ma|
|00000e00| 63 72 6f 2c 20 66 6f 6c | 6c 6f 77 65 64 20 62 79 |cro, fol|lowed by|
|00000e10| 0d 3b 20 6f 6e 65 20 6f | 72 20 6d 6f 72 65 20 42 |.; one o|r more B|
|00000e20| 59 54 45 5f 50 41 52 41 | 4d 2c 20 57 4f 52 44 5f |YTE_PARA|M, WORD_|
|00000e30| 50 41 52 41 4d 2c 20 61 | 6e 64 20 4c 4f 4e 47 5f |PARAM, a|nd LONG_|
|00000e40| 50 41 52 41 4d 20 6d 61 | 63 72 6f 73 20 74 6f 20 |PARAM ma|cros to |
|00000e50| 64 65 63 6c 61 72 65 20 | 74 68 65 0d 3b 20 70 61 |declare |the.; pa|
|00000e60| 72 61 6d 65 74 65 72 73 | 20 6f 66 20 74 68 65 20 |rameters| of the |
|00000e70| 73 75 62 72 6f 75 74 69 | 6e 65 2e 20 54 68 65 73 |subrouti|ne. Thes|
|00000e80| 65 20 6d 61 63 72 6f 73 | 20 73 65 74 20 74 68 65 |e macros| set the|
|00000e90| 20 61 73 73 65 6d 62 6c | 65 72 20 76 61 72 69 61 | assembl|er varia|
|00000ea0| 62 6c 65 73 20 66 6f 72 | 0d 3b 20 74 68 65 20 6f |bles for|.; the o|
|00000eb0| 66 66 73 65 74 73 20 74 | 6f 20 65 61 63 68 20 70 |ffsets t|o each p|
|00000ec0| 61 72 61 6d 65 74 65 72 | 20 61 6e 64 20 74 68 65 |arameter| and the|
|00000ed0| 20 74 6f 74 61 6c 20 6c | 65 6e 67 74 68 20 6f 66 | total l|ength of|
|00000ee0| 20 74 68 65 20 70 61 72 | 61 6d 65 74 65 72 20 73 | the par|ameter s|
|00000ef0| 70 61 63 65 2e 0d 3b 20 | 20 20 20 44 65 63 6c 61 |pace..; |   Decla|
|00000f00| 72 65 20 74 68 65 20 70 | 61 72 61 6d 65 74 65 72 |re the p|arameter|
|00000f10| 73 20 69 6e 20 50 61 73 | 63 61 6c 20 6f 72 64 65 |s in Pas|cal orde|
|00000f20| 72 69 6e 67 2c 20 69 2e | 65 2e 20 74 68 65 20 73 |ring, i.|e. the s|
|00000f30| 61 6d 65 20 6f 72 64 65 | 72 20 74 68 61 74 0d 3b |ame orde|r that.;|
|00000f40| 20 74 68 65 79 27 72 65 | 20 70 75 73 68 65 64 20 | they're| pushed |
|00000f50| 6f 6e 74 6f 20 74 68 65 | 20 73 74 61 63 6b 20 77 |onto the| stack w|
|00000f60| 68 65 6e 20 74 68 65 20 | 73 75 62 72 6f 75 74 69 |hen the |subrouti|
|00000f70| 6e 65 20 69 73 20 63 61 | 6c 6c 65 64 2e 0d 3b 0d |ne is ca|lled..;.|
|00000f80| 0d 6d 61 63 72 6f 20 53 | 54 41 43 4b 5f 44 45 43 |.macro S|TACK_DEC|
|00000f90| 4c 41 52 45 20 3d 0d 09 | 6c 61 73 74 5f 70 61 72 |LARE =..|last_par|
|00000fa0| 61 6d 20 73 65 74 20 30 | 0d 09 7c 0d 0d 0d 6d 61 |am set 0|..|...ma|
|00000fb0| 63 72 6f 20 42 59 54 45 | 5f 50 41 52 41 4d 20 6e |cro BYTE|_PARAM n|
|00000fc0| 61 6d 65 20 3d 0d 09 6c | 61 73 74 5f 70 61 72 61 |ame =..l|ast_para|
|00000fd0| 6d 20 73 65 74 20 6c 61 | 73 74 5f 70 61 72 61 6d |m set la|st_param|
|00000fe0| 20 2d 20 32 0d 09 70 61 | 72 6d 5f 7b 6e 61 6d 65 | - 2..pa|rm_{name|
|00000ff0| 7d 20 73 65 74 20 6c 61 | 73 74 5f 70 61 72 61 6d |} set la|st_param|
|00001000| 0d 09 7c 0d 0d 6d 61 63 | 72 6f 20 57 4f 52 44 5f |..|..mac|ro WORD_|
|00001010| 50 41 52 41 4d 20 6e 61 | 6d 65 20 3d 0d 09 6c 61 |PARAM na|me =..la|
|00001020| 73 74 5f 70 61 72 61 6d | 20 73 65 74 20 6c 61 73 |st_param| set las|
|00001030| 74 5f 70 61 72 61 6d 20 | 2d 20 32 0d 09 70 61 72 |t_param |- 2..par|
|00001040| 6d 5f 7b 6e 61 6d 65 7d | 20 73 65 74 20 6c 61 73 |m_{name}| set las|
|00001050| 74 5f 70 61 72 61 6d 0d | 09 7c 0d 0d 6d 61 63 72 |t_param.|.|..macr|
|00001060| 6f 20 4c 4f 4e 47 5f 50 | 41 52 41 4d 20 6e 61 6d |o LONG_P|ARAM nam|
|00001070| 65 20 3d 0d 09 6c 61 73 | 74 5f 70 61 72 61 6d 20 |e =..las|t_param |
|00001080| 73 65 74 20 6c 61 73 74 | 5f 70 61 72 61 6d 20 2d |set last|_param -|
|00001090| 20 34 0d 09 70 61 72 6d | 5f 7b 6e 61 6d 65 7d 20 | 4..parm|_{name} |
|000010a0| 73 65 74 20 6c 61 73 74 | 5f 70 61 72 61 6d 0d 09 |set last|_param..|
|000010b0| 7c 0d 0d 3b 20 20 20 20 | 41 66 74 65 72 20 64 65 ||..;    |After de|
|000010c0| 63 6c 61 72 69 6e 67 20 | 74 68 65 20 70 61 72 61 |claring |the para|
|000010d0| 6d 65 74 65 72 73 2c 20 | 75 73 65 20 74 68 65 20 |meters, |use the |
|000010e0| 53 54 41 43 4b 5f 42 45 | 47 49 4e 20 6d 61 63 72 |STACK_BE|GIN macr|
|000010f0| 6f 2e 20 20 54 68 69 73 | 20 6d 61 63 72 6f 0d 3b |o.  This| macro.;|
|00001100| 20 73 61 76 65 73 20 41 | 36 20 6f 6e 20 74 68 65 | saves A|6 on the|
|00001110| 20 73 74 61 63 6b 2c 20 | 74 68 65 6e 20 6d 61 6b | stack, |then mak|
|00001120| 65 73 20 41 36 20 70 6f | 69 6e 74 20 74 6f 20 74 |es A6 po|int to t|
|00001130| 68 65 20 66 69 72 73 74 | 20 62 79 74 65 20 61 66 |he first| byte af|
|00001140| 74 65 72 20 74 68 65 20 | 6c 61 73 74 0d 3b 20 62 |ter the |last.; b|
|00001150| 79 74 65 20 69 6e 20 74 | 68 65 20 70 61 72 61 6d |yte in t|he param|
|00001160| 65 74 65 72 20 73 70 61 | 63 65 2e 20 20 49 6e 20 |eter spa|ce.  In |
|00001170| 6f 74 68 65 72 20 77 6f | 72 64 73 2c 20 41 36 20 |other wo|rds, A6 |
|00001180| 70 6f 69 6e 74 73 20 61 | 74 20 74 68 65 20 72 65 |points a|t the re|
|00001190| 74 75 72 6e 20 76 61 6c | 75 65 0d 3b 20 28 69 66 |turn val|ue.; (if|
|000011a0| 20 61 6e 79 29 2e 20 41 | 66 74 65 72 20 53 54 41 | any). A|fter STA|
|000011b0| 43 4b 5f 42 45 47 49 4e | 2c 20 74 68 65 20 73 74 |CK_BEGIN|, the st|
|000011c0| 61 63 6b 20 6c 6f 6f 6b | 73 20 6c 69 6b 65 20 74 |ack look|s like t|
|000011d0| 68 69 73 3a 0d 3b 0d 3b | 20 20 20 20 20 20 20 20 |his:.;.;|        |
|000011e0| 20 20 20 20 20 53 50 20 | 20 20 20 20 20 20 20 20 |     SP |        |
|000011f0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 6c 61 73 |        |     las|
|00001200| 74 5f 70 61 72 61 6d 28 | 41 36 29 20 20 20 20 41 |t_param(|A6)    A|
|00001210| 36 0d 3b 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |6.;     |        |
|00001220| 7c 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 ||       |        |
|00001230| 20 20 20 20 20 20 20 20 | 7c 20 20 20 20 20 20 20 |        ||       |
|00001240| 20 20 20 20 20 20 20 20 | 20 20 7c 0d 3b 20 20 20 |        |  |.;   |
|00001250| 20 20 20 20 20 2d 2d 2d | 2d 2b 2d 2d 2d 2d 2d 2d |     ---|-+------|
|00001260| 2d 2d 2d 2d 2d 2b 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |-----+--|--------|
|00001270| 2d 2b 2d 2d 2d 2d 2d 2b | 2d 2d 2d 2d 2d 2d 2d 2d |-+-----+|--------|
|00001280| 2d 2d 2d 2b 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2b |---+----|-------+|
|00001290| 2d 2d 2d 0d 3b 20 53 74 | 61 63 6b 20 67 72 6f 77 |---.; St|ack grow|
|000012a0| 73 7c 20 20 20 20 6f 6c | 64 20 20 20 20 7c 20 20 |s|    ol|d    |  |
|000012b0| 20 72 65 74 75 72 6e 20 | 20 7c 77 6f 72 64 20 7c | return | |word ||
|000012c0| 20 20 20 6c 6f 6e 67 20 | 20 20 20 7c 20 20 20 72 |   long |   |   r|
|000012d0| 65 74 75 72 6e 20 20 7c | 20 68 69 67 68 65 72 0d |eturn  || higher.|
|000012e0| 3b 3c 2d 2d 20 74 68 69 | 73 20 77 61 79 7c 20 20 |;<-- thi|s way|  |
|000012f0| 20 20 20 41 36 20 20 20 | 20 7c 20 20 61 64 64 72 |   A6   | |  addr|
|00001300| 65 73 73 20 20 7c 70 61 | 72 61 6d 7c 20 20 20 70 |ess  |pa|ram|   p|
|00001310| 61 72 61 6d 20 20 20 7c | 20 20 20 76 61 6c 75 65 |aram   ||   value|
|00001320| 20 20 20 7c 20 6d 65 6d | 6f 72 79 0d 3b 20 20 20 |   | mem|ory.;   |
|00001330| 20 20 20 20 20 2d 2d 2d | 2d 2b 2d 2d 2d 2d 2d 2d |     ---|-+------|
|00001340| 2d 2d 2d 2d 2d 2b 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |-----+--|--------|
|00001350| 2d 2b 2d 2d 2d 2d 2d 2b | 2d 2d 2d 2d 2d 2d 2d 2d |-+-----+|--------|
|00001360| 2d 2d 2d 2b 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2b |---+----|-------+|
|00001370| 2d 2d 2d 0d 3b 0d 3b 20 | 20 20 20 50 6c 65 61 73 |---.;.; |   Pleas|
|00001380| 65 20 6e 6f 74 65 20 74 | 68 61 74 20 74 68 69 73 |e note t|hat this|
|00001390| 20 69 73 20 71 75 69 74 | 65 20 64 69 66 66 65 72 | is quit|e differ|
|000013a0| 65 6e 74 20 66 72 6f 6d | 20 74 68 65 20 4c 49 4e |ent from| the LIN|
|000013b0| 4b 20 69 6e 73 74 72 75 | 63 74 69 6f 6e 2c 20 77 |K instru|ction, w|
|000013c0| 68 69 63 68 0d 3b 20 69 | 73 20 6e 6f 72 6d 61 6c |hich.; i|s normal|
|000013d0| 6c 79 20 75 73 65 64 20 | 74 6f 20 73 74 61 72 74 |ly used |to start|
|000013e0| 20 61 20 73 74 61 63 6b | 2d 62 61 73 65 64 20 73 | a stack|-based s|
|000013f0| 75 62 72 6f 75 74 69 6e | 65 2e 20 20 49 66 20 77 |ubroutin|e.  If w|
|00001400| 65 20 75 73 65 64 20 4c | 49 4e 4b 2c 20 74 68 65 |e used L|INK, the|
|00001410| 0d 3b 20 69 6d 70 6c 65 | 6d 65 6e 74 61 74 69 6f |.; imple|mentatio|
|00001420| 6e 20 6f 66 20 74 68 65 | 73 65 20 6d 61 63 72 6f |n of the|se macro|
|00001430| 73 20 77 6f 75 6c 64 20 | 62 65 20 73 6f 6d 65 77 |s would |be somew|
|00001440| 68 61 74 20 6d 6f 72 65 | 20 63 6f 6d 70 6c 65 78 |hat more| complex|
|00001450| 20 28 62 65 63 61 75 73 | 65 20 4c 49 4e 4b 0d 3b | (becaus|e LINK.;|
|00001460| 20 72 65 71 75 69 72 65 | 73 20 6b 6e 6f 77 6c 65 | require|s knowle|
|00001470| 64 67 65 20 6f 66 20 74 | 68 65 20 73 69 7a 65 20 |dge of t|he size |
|00001480| 6f 66 20 74 68 65 20 6c | 6f 63 61 6c 20 76 61 72 |of the l|ocal var|
|00001490| 69 61 62 6c 65 20 73 70 | 61 63 65 2e 29 0d 3b 0d |iable sp|ace.).;.|
|000014a0| 6d 61 63 72 6f 20 53 54 | 41 43 4b 5f 42 45 47 49 |macro ST|ACK_BEGI|
|000014b0| 4e 20 3d 0d 09 6d 6f 76 | 65 2e 6c 20 61 36 2c 2d |N =..mov|e.l a6,-|
|000014c0| 28 73 70 29 0d 09 6c 65 | 61 20 38 2d 6c 61 73 74 |(sp)..le|a 8-last|
|000014d0| 5f 70 61 72 61 6d 28 73 | 70 29 2c 61 36 0d 09 6c |_param(s|p),a6..l|
|000014e0| 61 73 74 5f 6c 6f 63 61 | 6c 20 73 65 74 20 6c 61 |ast_loca|l set la|
|000014f0| 73 74 5f 70 61 72 61 6d | 20 2d 20 38 0d 09 7c 0d |st_param| - 8..|.|
|00001500| 0d 3b 20 20 20 20 4e 65 | 78 74 2c 20 75 73 65 20 |.;    Ne|xt, use |
|00001510| 74 68 65 20 6d 61 63 72 | 6f 73 20 42 59 54 45 5f |the macr|os BYTE_|
|00001520| 4c 4f 43 41 4c 2c 20 57 | 4f 52 44 5f 4c 4f 43 41 |LOCAL, W|ORD_LOCA|
|00001530| 4c 2c 20 4c 4f 4e 47 5f | 4c 4f 43 41 4c 2c 20 61 |L, LONG_|LOCAL, a|
|00001540| 6e 64 20 41 52 52 41 59 | 5f 4c 4f 43 41 4c 0d 3b |nd ARRAY|_LOCAL.;|
|00001550| 20 74 6f 20 64 65 63 6c | 61 72 65 20 74 68 65 20 | to decl|are the |
|00001560| 6c 6f 63 61 6c 20 76 61 | 72 69 61 62 6c 65 73 2e |local va|riables.|
|00001570| 20 20 54 68 65 73 65 20 | 6d 61 63 72 6f 73 20 67 |  These |macros g|
|00001580| 65 6e 65 72 61 74 65 20 | 63 6f 64 65 20 74 6f 20 |enerate |code to |
|00001590| 6d 6f 76 65 20 74 68 65 | 20 73 74 61 63 6b 0d 3b |move the| stack.;|
|000015a0| 20 70 6f 69 6e 74 65 72 | 20 64 6f 77 6e 20 62 79 | pointer| down by|
|000015b0| 20 74 68 65 20 61 70 70 | 72 6f 70 72 69 61 74 65 | the app|ropriate|
|000015c0| 20 61 6d 6f 75 6e 74 20 | 66 6f 72 20 65 61 63 68 | amount |for each|
|000015d0| 20 6c 6f 63 61 6c 20 76 | 61 72 69 61 62 6c 65 2e | local v|ariable.|
|000015e0| 20 20 41 66 74 65 72 20 | 74 68 65 0d 3b 20 6c 6f |  After |the.; lo|
|000015f0| 63 61 6c 73 20 61 72 65 | 20 64 65 63 6c 61 72 65 |cals are| declare|
|00001600| 64 2c 20 74 68 65 20 73 | 74 61 63 6b 20 77 69 6c |d, the s|tack wil|
|00001610| 6c 20 6c 6f 6f 6b 20 73 | 6f 6d 65 74 68 69 6e 67 |l look s|omething|
|00001620| 20 6c 69 6b 65 20 74 68 | 69 73 3a 0d 3b 0d 3b 20 | like th|is:.;.; |
|00001630| 20 20 20 20 20 20 20 20 | 20 20 20 20 53 50 20 20 |        |    SP  |
|00001640| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00001650| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00001660| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00001670| 20 20 41 36 0d 3b 20 20 | 20 20 20 20 20 20 20 20 |  A6.;  |        |
|00001680| 20 20 20 7c 20 20 20 20 | 20 20 20 20 20 20 20 20 |   |    |        |
|00001690| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|000016a0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|000016b0| 20 20 20 20 20 20 20 20 | 20 7c 0d 3b 20 20 20 20 |        | |.;    |
|000016c0| 20 20 20 20 2d 2d 2d 2d | 2b 2d 2d 2d 2d 2d 2b 2d |    ----|+-----+-|
|000016d0| 2d 2d 2d 2d 2b 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |----+---|--------|
|000016e0| 2b 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2b 2d 2d 2d |+-------|----+---|
|000016f0| 2d 2d 2b 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2b 2d |--+-----|------+-|
|00001700| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2b 2d 2d 2d 0d 3b |--------|--+---.;|
|00001710| 20 53 74 61 63 6b 20 67 | 72 6f 77 73 7c 62 79 74 | Stack g|rows|byt|
|00001720| 65 20 7c 77 6f 72 64 20 | 7c 20 20 20 20 6f 6c 64 |e |word ||    old|
|00001730| 20 20 20 20 7c 20 20 20 | 72 65 74 75 72 6e 20 20 |    |   |return  |
|00001740| 7c 77 6f 72 64 20 7c 20 | 20 20 6c 6f 6e 67 20 20 ||word | |  long  |
|00001750| 20 20 7c 20 20 20 72 65 | 74 75 72 6e 20 20 7c 20 |  |   re|turn  | |
|00001760| 68 69 67 68 65 72 0d 3b | 3c 2d 2d 20 74 68 69 73 |higher.;|<-- this|
|00001770| 20 77 61 79 7c 6c 6f 63 | 61 6c 7c 6c 6f 63 61 6c | way|loc|al|local|
|00001780| 7c 20 20 20 20 20 41 36 | 20 20 20 20 7c 20 20 61 ||     A6|    |  a|
|00001790| 64 64 72 65 73 73 20 20 | 7c 70 61 72 61 6d 7c 20 |ddress  ||param| |
|000017a0| 20 20 70 61 72 61 6d 20 | 20 20 7c 20 20 20 76 61 |  param |  |   va|
|000017b0| 6c 75 65 20 20 20 7c 20 | 6d 65 6d 6f 72 79 0d 3b |lue   | |memory.;|
|000017c0| 20 20 20 20 20 20 20 20 | 2d 2d 2d 2d 2b 2d 2d 2d |        |----+---|
|000017d0| 2d 2d 2b 2d 2d 2d 2d 2d | 2b 2d 2d 2d 2d 2d 2d 2d |--+-----|+-------|
|000017e0| 2d 2d 2d 2d 2b 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |----+---|--------|
|000017f0| 2b 2d 2d 2d 2d 2d 2b 2d | 2d 2d 2d 2d 2d 2d 2d 2d |+-----+-|--------|
|00001800| 2d 2d 2b 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2b 2d |--+-----|------+-|
|00001810| 2d 2d 0d 3b 0d 6d 61 63 | 72 6f 20 4c 4f 4e 47 5f |--.;.mac|ro LONG_|
|00001820| 4c 4f 43 41 4c 20 6e 61 | 6d 65 20 3d 0d 09 6c 61 |LOCAL na|me =..la|
|00001830| 73 74 5f 6c 6f 63 61 6c | 20 73 65 74 20 6c 61 73 |st_local| set las|
|00001840| 74 5f 6c 6f 63 61 6c 20 | 2d 20 34 0d 09 6c 6f 63 |t_local |- 4..loc|
|00001850| 6c 5f 7b 6e 61 6d 65 7d | 20 73 65 74 20 6c 61 73 |l_{name}| set las|
|00001860| 74 5f 6c 6f 63 61 6c 0d | 09 73 75 62 71 2e 6c 20 |t_local.|.subq.l |
|00001870| 23 34 2c 73 70 0d 09 7c | 0d 0d 6d 61 63 72 6f 20 |#4,sp..||..macro |
|00001880| 57 4f 52 44 5f 4c 4f 43 | 41 4c 20 6e 61 6d 65 20 |WORD_LOC|AL name |
|00001890| 3d 0d 09 6c 61 73 74 5f | 6c 6f 63 61 6c 20 73 65 |=..last_|local se|
|000018a0| 74 20 6c 61 73 74 5f 6c | 6f 63 61 6c 20 2d 20 32 |t last_l|ocal - 2|
|000018b0| 0d 09 6c 6f 63 6c 5f 7b | 6e 61 6d 65 7d 20 73 65 |..locl_{|name} se|
|000018c0| 74 20 6c 61 73 74 5f 6c | 6f 63 61 6c 0d 09 73 75 |t last_l|ocal..su|
|000018d0| 62 71 2e 6c 20 23 32 2c | 73 70 0d 09 7c 0d 0d 6d |bq.l #2,|sp..|..m|
|000018e0| 61 63 72 6f 20 42 59 54 | 45 5f 4c 4f 43 41 4c 20 |acro BYT|E_LOCAL |
|000018f0| 6e 61 6d 65 20 3d 0d 09 | 6c 61 73 74 5f 6c 6f 63 |name =..|last_loc|
|00001900| 61 6c 20 73 65 74 20 6c | 61 73 74 5f 6c 6f 63 61 |al set l|ast_loca|
|00001910| 6c 20 2d 20 32 0d 09 6c | 6f 63 6c 5f 7b 6e 61 6d |l - 2..l|ocl_{nam|
|00001920| 65 7d 20 73 65 74 20 6c | 61 73 74 5f 6c 6f 63 61 |e} set l|ast_loca|
|00001930| 6c 0d 09 73 75 62 71 2e | 6c 20 23 32 2c 73 70 0d |l..subq.|l #2,sp.|
|00001940| 09 7c 0d 0d 3b 20 4e 4f | 54 45 3a 20 20 57 68 65 |.|..; NO|TE:  Whe|
|00001950| 6e 20 64 65 63 6c 61 72 | 69 6e 67 20 61 6e 20 61 |n declar|ing an a|
|00001960| 72 72 61 79 20 6c 6f 63 | 61 6c 2c 20 74 68 65 20 |rray loc|al, the |
|00001970| 6e 75 6d 62 65 72 20 6f | 66 20 62 79 74 65 73 20 |number o|f bytes |
|00001980| 73 70 65 63 69 66 69 65 | 64 20 4d 55 53 54 20 62 |specifie|d MUST b|
|00001990| 65 0d 3b 20 61 6e 20 65 | 76 65 6e 20 6e 75 6d 62 |e.; an e|ven numb|
|000019a0| 65 72 2e 20 20 49 66 20 | 69 74 20 69 73 6e 27 74 |er.  If |it isn't|
|000019b0| 2c 20 74 68 65 20 4d 61 | 63 20 77 69 6c 6c 20 72 |, the Ma|c will r|
|000019c0| 65 62 6f 6f 74 20 28 72 | 65 61 6c 6c 79 21 29 20 |eboot (r|eally!) |
|000019d0| 61 73 20 73 6f 6f 6e 20 | 61 73 20 74 68 65 0d 3b |as soon |as the.;|
|000019e0| 20 73 75 62 72 6f 75 74 | 69 6e 65 20 74 72 69 65 | subrout|ine trie|
|000019f0| 73 20 74 6f 20 75 73 65 | 20 74 68 65 20 73 74 61 |s to use| the sta|
|00001a00| 63 6b 20 6f 72 20 63 61 | 6c 6c 20 61 6e 6f 74 68 |ck or ca|ll anoth|
|00001a10| 65 72 20 73 75 62 72 6f | 75 74 69 6e 65 2e 20 20 |er subro|utine.  |
|00001a20| 28 54 72 79 69 6e 67 20 | 74 6f 0d 3b 20 70 75 73 |(Trying |to.; pus|
|00001a30| 68 20 6f 72 20 70 6f 70 | 20 73 6f 6d 65 74 68 69 |h or pop| somethi|
|00001a40| 6e 67 20 6f 6e 20 74 68 | 65 20 73 74 61 63 6b 20 |ng on th|e stack |
|00001a50| 77 68 65 6e 20 74 68 65 | 20 53 50 20 69 73 20 6f |when the| SP is o|
|00001a60| 64 64 20 63 61 75 73 65 | 73 20 61 20 22 64 6f 75 |dd cause|s a "dou|
|00001a70| 62 6c 65 20 62 75 73 0d | 3b 20 66 61 75 6c 74 22 |ble bus.|; fault"|
|00001a80| 2c 20 77 68 69 63 68 20 | 63 61 75 73 65 73 20 74 |, which |causes t|
|00001a90| 68 65 20 73 79 73 74 65 | 6d 20 74 6f 20 72 65 62 |he syste|m to reb|
|00001aa0| 6f 6f 74 2e 29 0d 3b 0d | 6d 61 63 72 6f 20 41 52 |oot.).;.|macro AR|
|00001ab0| 52 41 59 5f 4c 4f 43 41 | 4c 20 6e 61 6d 65 2c 73 |RAY_LOCA|L name,s|
|00001ac0| 69 7a 65 20 3d 0d 09 6c | 61 73 74 5f 6c 6f 63 61 |ize =..l|ast_loca|
|00001ad0| 6c 20 73 65 74 20 6c 61 | 73 74 5f 6c 6f 63 61 6c |l set la|st_local|
|00001ae0| 20 2d 20 7b 73 69 7a 65 | 7d 0d 09 6c 6f 63 6c 5f | - {size|}..locl_|
|00001af0| 7b 6e 61 6d 65 7d 20 73 | 65 74 20 6c 61 73 74 5f |{name} s|et last_|
|00001b00| 6c 6f 63 61 6c 0d 09 6c | 65 61 20 2d 7b 73 69 7a |local..l|ea -{siz|
|00001b10| 65 7d 28 73 70 29 2c 73 | 70 0d 09 7c 0d 0d 3b 20 |e}(sp),s|p..|..; |
|00001b20| 41 66 74 65 72 20 74 68 | 65 20 70 61 72 61 6d 65 |After th|e parame|
|00001b30| 74 65 72 73 20 61 6e 64 | 20 6c 6f 63 61 6c 73 20 |ters and| locals |
|00001b40| 61 72 65 20 64 65 63 6c | 61 72 65 64 2c 20 73 74 |are decl|ared, st|
|00001b50| 61 72 74 20 74 68 65 20 | 61 63 74 75 61 6c 20 63 |art the |actual c|
|00001b60| 6f 64 65 20 6f 66 20 74 | 68 65 0d 3b 20 73 75 62 |ode of t|he.; sub|
|00001b70| 72 6f 75 74 69 6e 65 2e | 20 52 65 66 65 72 20 74 |routine.| Refer t|
|00001b80| 6f 20 61 20 6c 6f 63 61 | 6c 20 6f 72 20 70 61 72 |o a loca|l or par|
|00001b90| 61 6d 65 74 65 72 20 22 | 66 6f 6f 22 20 62 79 20 |ameter "|foo" by |
|00001ba0| 22 6c 6f 63 6c 5f 66 6f | 6f 28 41 36 29 22 20 6f |"locl_fo|o(A6)" o|
|00001bb0| 72 0d 3b 20 22 70 61 72 | 6d 5f 66 6f 6f 28 41 36 |r.; "par|m_foo(A6|
|00001bc0| 29 22 20 61 73 20 61 70 | 70 72 6f 70 72 69 61 74 |)" as ap|propriat|
|00001bd0| 65 2e 20 52 65 66 65 72 | 20 74 6f 20 74 68 65 20 |e. Refer| to the |
|00001be0| 72 65 74 75 72 6e 20 76 | 61 6c 75 65 20 61 73 20 |return v|alue as |
|00001bf0| 22 28 41 36 29 22 2e 0d | 3b 0d 0d 3b 20 41 74 20 |"(A6)"..|;..; At |
|00001c00| 74 68 65 20 65 6e 64 20 | 6f 66 20 74 68 65 20 73 |the end |of the s|
|00001c10| 75 62 72 6f 75 74 69 6e | 65 2c 20 75 73 65 20 74 |ubroutin|e, use t|
|00001c20| 68 65 20 53 54 41 43 4b | 5f 45 4e 44 20 6d 61 63 |he STACK|_END mac|
|00001c30| 72 6f 20 69 6e 20 70 6c | 61 63 65 20 6f 66 20 61 |ro in pl|ace of a|
|00001c40| 6e 20 52 54 53 0d 3b 20 | 69 6e 73 74 72 75 63 74 |n RTS.; |instruct|
|00001c50| 69 6f 6e 2e 20 4e 6f 74 | 65 20 74 68 61 74 20 74 |ion. Not|e that t|
|00001c60| 68 65 20 73 75 62 72 6f | 75 74 69 6e 65 20 6d 69 |he subro|utine mi|
|00001c70| 67 68 74 20 68 61 76 65 | 20 6c 65 66 74 20 73 6f |ght have| left so|
|00001c80| 6d 65 20 65 78 74 72 61 | 20 67 61 72 62 61 67 65 |me extra| garbage|
|00001c90| 20 6f 6e 0d 3b 20 74 68 | 65 20 73 74 61 63 6b 2e | on.; th|e stack.|
|00001ca0| 20 54 68 65 72 65 66 6f | 72 65 2c 20 74 68 65 20 | Therefo|re, the |
|00001cb0| 73 74 61 63 6b 20 77 69 | 6c 6c 20 6c 6f 6f 6b 20 |stack wi|ll look |
|00001cc0| 73 6f 6d 65 74 68 69 6e | 67 20 6c 69 6b 65 20 74 |somethin|g like t|
|00001cd0| 68 69 73 3a 0d 3b 0d 3b | 20 20 20 20 20 20 20 20 |his:.;.;|        |
|00001ce0| 20 20 20 20 20 53 50 20 | 20 20 20 20 20 20 20 20 |     SP |        |
|00001cf0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 6c 61 73 |        |     las|
|00001d00| 74 5f 70 61 72 61 6d 2d | 38 28 41 36 29 20 20 20 |t_param-|8(A6)   |
|00001d10| 20 20 20 20 20 6c 61 73 | 74 5f 70 61 72 61 6d 28 |     las|t_param(|
|00001d20| 41 36 29 20 20 20 20 41 | 36 0d 3b 20 20 20 20 20 |A6)    A|6.;     |
|00001d30| 20 20 20 20 20 20 20 20 | 7c 20 20 20 20 20 20 20 |        ||       |
|00001d40| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00001d50| 7c 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 ||       |        |
|00001d60| 20 20 20 20 20 20 20 20 | 7c 20 20 20 20 20 20 20 |        ||       |
|00001d70| 20 20 20 20 20 20 20 20 | 20 20 7c 0d 3b 20 20 20 |        |  |.;   |
|00001d80| 20 20 20 20 20 2d 2d 2d | 2d 2b 2d 2d 2d 2d 2d 2d |     ---|-+------|
|00001d90| 2d 2d 2d 2d 2d 2b 2d 2d | 2d 2d 2d 2b 2d 2d 2d 2d |-----+--|---+----|
|00001da0| 2d 2b 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2b 2d 2d |-+------|-----+--|
|00001db0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2b 2d 2d 2d 2d 2d 2b |--------|-+-----+|
|00001dc0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2b 2d 2d 2d 2d |--------|---+----|
|00001dd0| 2d 2d 2d 2d 2d 2d 2d 2b | 2d 2d 2d 0d 3b 20 53 74 |-------+|---.; St|
|00001de0| 61 63 6b 20 67 72 6f 77 | 73 7c 20 20 20 65 78 74 |ack grow|s|   ext|
|00001df0| 72 61 20 20 20 7c 62 79 | 74 65 20 7c 77 6f 72 64 |ra   |by|te |word|
|00001e00| 20 7c 20 20 20 20 6f 6c | 64 20 20 20 20 7c 20 20 | |    ol|d    |  |
|00001e10| 20 72 65 74 75 72 6e 20 | 20 7c 77 6f 72 64 20 7c | return | |word ||
|00001e20| 20 20 20 6c 6f 6e 67 20 | 20 20 20 7c 20 20 20 72 |   long |   |   r|
|00001e30| 65 74 75 72 6e 20 20 7c | 20 68 69 67 68 65 72 0d |eturn  || higher.|
|00001e40| 3b 3c 2d 2d 20 74 68 69 | 73 20 77 61 79 7c 20 20 |;<-- thi|s way|  |
|00001e50| 67 61 72 62 61 67 65 20 | 20 7c 6c 6f 63 61 6c 7c |garbage | |local||
|00001e60| 6c 6f 63 61 6c 7c 20 20 | 20 20 20 41 36 20 20 20 |local|  |   A6   |
|00001e70| 20 7c 20 20 61 64 64 72 | 65 73 73 20 20 7c 70 61 | |  addr|ess  |pa|
|00001e80| 72 61 6d 7c 20 20 20 70 | 61 72 61 6d 20 20 20 7c |ram|   p|aram   ||
|00001e90| 20 20 20 76 61 6c 75 65 | 20 20 20 7c 20 6d 65 6d |   value|   | mem|
|00001ea0| 6f 72 79 0d 3b 20 20 20 | 20 20 20 20 20 2d 2d 2d |ory.;   |     ---|
|00001eb0| 2d 2b 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2b 2d 2d |-+------|-----+--|
|00001ec0| 2d 2d 2d 2b 2d 2d 2d 2d | 2d 2b 2d 2d 2d 2d 2d 2d |---+----|-+------|
|00001ed0| 2d 2d 2d 2d 2d 2b 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |-----+--|--------|
|00001ee0| 2d 2b 2d 2d 2d 2d 2d 2b | 2d 2d 2d 2d 2d 2d 2d 2d |-+-----+|--------|
|00001ef0| 2d 2d 2d 2b 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2b |---+----|-------+|
|00001f00| 2d 2d 2d 0d 3b 0d 3b 20 | 53 54 41 43 4b 5f 45 4e |---.;.; |STACK_EN|
|00001f10| 44 20 77 6f 72 6b 73 20 | 69 6e 20 66 69 76 65 20 |D works |in five |
|00001f20| 73 74 65 70 73 3a 20 20 | 46 69 72 73 74 2c 20 69 |steps:  |First, i|
|00001f30| 74 20 64 69 73 63 61 72 | 64 73 20 74 68 65 20 67 |t discar|ds the g|
|00001f40| 61 72 62 61 67 65 20 61 | 6e 64 20 74 68 65 20 6c |arbage a|nd the l|
|00001f50| 6f 63 61 6c 0d 3b 20 76 | 61 72 69 61 62 6c 65 73 |ocal.; v|ariables|
|00001f60| 20 62 79 20 73 65 74 74 | 69 6e 67 20 74 68 65 20 | by sett|ing the |
|00001f70| 53 50 20 74 6f 20 74 68 | 65 20 6c 6f 63 61 74 69 |SP to th|e locati|
|00001f80| 6f 6e 20 6f 66 20 74 68 | 65 20 6f 6c 64 20 41 36 |on of th|e old A6|
|00001f90| 2e 20 20 53 65 63 6f 6e | 64 2c 20 69 74 20 70 6f |.  Secon|d, it po|
|00001fa0| 70 73 0d 3b 20 74 68 65 | 20 6f 6c 64 20 41 36 20 |ps.; the| old A6 |
|00001fb0| 6f 66 66 20 74 68 65 20 | 73 74 61 63 6b 20 74 6f |off the |stack to|
|00001fc0| 20 72 65 73 74 6f 72 65 | 20 41 36 2e 20 20 54 68 | restore| A6.  Th|
|00001fd0| 69 72 64 2c 20 69 74 20 | 63 6f 70 69 65 73 20 74 |ird, it |copies t|
|00001fe0| 68 65 20 72 65 74 75 72 | 6e 20 61 64 64 72 65 73 |he retur|n addres|
|00001ff0| 73 0d 3b 20 6f 6e 74 6f | 20 74 68 65 20 74 6f 70 |s.; onto| the top|
|00002000| 20 66 6f 75 72 20 62 79 | 74 65 73 20 6f 66 20 74 | four by|tes of t|
|00002010| 68 65 20 70 61 72 61 6d | 65 74 65 72 20 73 70 61 |he param|eter spa|
|00002020| 63 65 2e 20 20 54 68 65 | 6e 2c 20 69 74 20 70 6f |ce.  The|n, it po|
|00002030| 69 6e 74 73 20 74 68 65 | 20 53 50 20 61 74 0d 3b |ints the| SP at.;|
|00002040| 20 74 68 69 73 20 61 64 | 64 72 65 73 73 2e 20 20 | this ad|dress.  |
|00002050| 46 69 6e 61 6c 6c 79 2c | 20 69 74 20 64 6f 65 73 |Finally,| it does|
|00002060| 20 61 6e 20 52 54 53 2c | 20 6c 65 61 76 69 6e 67 | an RTS,| leaving|
|00002070| 20 74 68 65 20 73 74 61 | 63 6b 20 65 6d 70 74 79 | the sta|ck empty|
|00002080| 20 65 78 63 65 70 74 20 | 66 6f 72 0d 3b 20 74 68 | except |for.; th|
|00002090| 65 20 72 65 74 75 72 6e | 20 76 61 6c 75 65 2e 20 |e return| value. |
|000020a0| 20 28 54 68 65 20 72 65 | 61 73 6f 6e 20 52 54 53 | (The re|ason RTS|
|000020b0| 20 69 73 20 75 73 65 64 | 20 69 6e 73 74 65 61 64 | is used| instead|
|000020c0| 20 6f 66 20 4a 4d 50 20 | 28 41 30 29 20 6f 72 20 | of JMP |(A0) or |
|000020d0| 73 6f 6d 65 74 68 69 6e | 67 0d 3b 20 6c 69 6b 65 |somethin|g.; like|
|000020e0| 20 74 68 61 74 20 69 73 | 20 74 6f 20 70 72 65 73 | that is| to pres|
|000020f0| 65 72 76 65 20 41 30 2e | 29 0d 3b 20 20 20 20 20 |erve A0.|).;     |
|00002100| 4e 4f 54 45 3a 20 49 74 | 20 69 73 20 64 6f 6e 65 |NOTE: It| is done|
|00002110| 20 74 68 69 73 20 77 61 | 79 20 74 6f 20 6d 61 6b | this wa|y to mak|
|00002120| 65 20 73 75 72 65 20 74 | 68 65 20 6d 61 63 72 6f |e sure t|he macro|
|00002130| 20 77 6f 72 6b 73 20 65 | 76 65 6e 20 69 66 20 74 | works e|ven if t|
|00002140| 68 65 0d 3b 20 73 75 62 | 72 6f 75 74 69 6e 65 20 |he.; sub|routine |
|00002150| 68 61 73 20 6e 6f 20 70 | 61 72 61 6d 65 74 65 72 |has no p|arameter|
|00002160| 73 2e 0d 3b 0d 6d 61 63 | 72 6f 20 53 54 41 43 4b |s..;.mac|ro STACK|
|00002170| 5f 45 4e 44 20 3d 0d 09 | 6c 65 61 20 6c 61 73 74 |_END =..|lea last|
|00002180| 5f 70 61 72 61 6d 2d 38 | 28 61 36 29 2c 73 70 0d |_param-8|(a6),sp.|
|00002190| 09 6d 6f 76 65 2e 6c 20 | 28 73 70 29 2b 2c 61 36 |.move.l |(sp)+,a6|
|000021a0| 0d 09 6d 6f 76 65 2e 6c | 20 28 73 70 29 2c 2d 6c |..move.l| (sp),-l|
|000021b0| 61 73 74 5f 70 61 72 61 | 6d 28 73 70 29 0d 09 6c |ast_para|m(sp)..l|
|000021c0| 65 61 20 2d 6c 61 73 74 | 5f 70 61 72 61 6d 28 73 |ea -last|_param(s|
|000021d0| 70 29 2c 73 70 0d 09 72 | 74 73 0d 09 7c 0d 0d 3b |p),sp..r|ts..|..;|
|000021e0| 20 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d | =======|========|
|000021f0| 3d 3d 3d 3d 3d 20 45 78 | 61 6d 70 6c 65 20 3d 3d |===== Ex|ample ==|
|00002200| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00002210| 0d 3b 0d 3b 20 20 20 20 | 49 6e 20 74 68 69 73 20 |.;.;    |In this |
|00002220| 65 78 61 6d 70 6c 65 2c | 20 77 65 20 77 61 6e 74 |example,| we want|
|00002230| 20 74 6f 20 77 72 69 74 | 65 20 61 6e 20 61 73 73 | to writ|e an ass|
|00002240| 65 6d 62 6c 79 2d 6c 61 | 6e 67 75 61 67 65 20 73 |embly-la|nguage s|
|00002250| 75 62 72 6f 75 74 69 6e | 65 20 77 68 69 63 68 0d |ubroutin|e which.|
|00002260| 3b 20 69 73 20 63 61 6c | 6c 65 64 20 69 6e 20 74 |; is cal|led in t|
|00002270| 68 65 20 73 61 6d 65 20 | 77 61 79 20 61 73 20 61 |he same |way as a|
|00002280| 20 50 61 73 63 61 6c 20 | 72 6f 75 74 69 6e 65 20 | Pascal |routine |
|00002290| 77 69 74 68 20 74 68 65 | 20 66 6f 6c 6c 6f 77 69 |with the| followi|
|000022a0| 6e 67 20 63 61 6c 6c 69 | 6e 67 0d 3b 20 73 65 71 |ng calli|ng.; seq|
|000022b0| 75 65 6e 63 65 3a 0d 3b | 0d 3b 20 46 75 6e 63 74 |uence:.;|.; Funct|
|000022c0| 69 6f 6e 20 4d 79 46 69 | 6c 74 65 72 20 28 74 68 |ion MyFi|lter (th|
|000022d0| 65 44 69 61 6c 6f 67 3a | 20 44 69 61 6c 6f 67 50 |eDialog:| DialogP|
|000022e0| 74 72 3b 20 56 41 52 20 | 74 68 65 45 76 65 6e 74 |tr; VAR |theEvent|
|000022f0| 3a 20 45 76 65 6e 74 52 | 65 63 6f 72 64 3b 0d 3b |: EventR|ecord;.;|
|00002300| 20 20 20 20 20 20 20 20 | 56 41 52 20 69 74 65 6d |        |VAR item|
|00002310| 48 69 74 3a 20 49 4e 54 | 45 47 45 52 29 20 3a 20 |Hit: INT|EGER) : |
|00002320| 42 4f 4f 4c 45 41 4e 3b | 0d 3b 0d 3b 20 20 20 20 |BOOLEAN;|.;.;    |
|00002330| 57 65 20 63 61 6e 20 77 | 72 69 74 65 20 73 75 63 |We can w|rite suc|
|00002340| 68 20 61 20 73 75 62 72 | 6f 75 74 69 6e 65 20 69 |h a subr|outine i|
|00002350| 6e 20 74 68 65 20 66 6f | 6c 6c 6f 77 69 6e 67 20 |n the fo|llowing |
|00002360| 77 61 79 3a 0d 3b 0d 3b | 20 5f 4d 79 46 69 6c 74 |way:.;.;| _MyFilt|
|00002370| 65 72 0d 3b 09 53 54 41 | 43 4b 5f 44 45 43 4c 41 |er.;.STA|CK_DECLA|
|00002380| 52 45 0d 3b 09 4c 4f 4e | 47 5f 50 41 52 41 4d 20 |RE.;.LON|G_PARAM |
|00002390| 64 69 61 6c 6f 67 5f 70 | 74 72 0d 3b 09 4c 4f 4e |dialog_p|tr.;.LON|
|000023a0| 47 5f 50 41 52 41 4d 20 | 65 76 65 6e 74 5f 72 65 |G_PARAM |event_re|
|000023b0| 63 5f 70 74 72 0d 3b 09 | 4c 4f 4e 47 5f 50 41 52 |c_ptr.;.|LONG_PAR|
|000023c0| 41 4d 20 69 74 65 6d 5f | 68 69 74 5f 70 74 72 0d |AM item_|hit_ptr.|
|000023d0| 3b 0d 3b 09 53 54 41 43 | 4b 5f 42 45 47 49 4e 0d |;.;.STAC|K_BEGIN.|
|000023e0| 3b 09 57 4f 52 44 5f 4c | 4f 43 41 4c 20 66 6f 6f |;.WORD_L|OCAL foo|
|000023f0| 0d 3b 09 42 59 54 45 5f | 4c 4f 43 41 4c 20 62 61 |.;.BYTE_|LOCAL ba|
|00002400| 72 0d 3b 0d 3b 09 53 41 | 56 45 5f 41 4c 4c 09 09 |r.;.;.SA|VE_ALL..|
|00002410| 3b 20 53 61 76 65 20 72 | 65 67 69 73 74 65 72 73 |; Save r|egisters|
|00002420| 0d 3b 0d 3b 09 6d 6f 76 | 65 2e 77 09 23 30 2c 20 |.;.;.mov|e.w.#0, |
|00002430| 6c 6f 63 6c 5f 62 61 72 | 28 61 36 29 09 3b 20 69 |locl_bar|(a6).; i|
|00002440| 6e 69 74 69 61 6c 69 7a | 65 20 6c 6f 63 61 6c 73 |nitializ|e locals|
|00002450| 0d 3b 09 6d 6f 76 65 2e | 77 09 23 24 66 66 66 66 |.;.move.|w.#$ffff|
|00002460| 2c 20 6c 6f 63 6c 5f 66 | 6f 6f 28 61 36 29 0d 3b |, locl_f|oo(a6).;|
|00002470| 0d 3b 09 6d 6f 76 65 2e | 6c 09 70 61 72 6d 5f 65 |.;.move.|l.parm_e|
|00002480| 76 65 6e 74 5f 72 65 63 | 5f 70 74 72 28 61 36 29 |vent_rec|_ptr(a6)|
|00002490| 2c 20 61 30 09 3b 20 47 | 65 74 20 70 6f 69 6e 74 |, a0.; G|et point|
|000024a0| 65 72 20 74 6f 20 45 76 | 65 6e 74 20 52 65 63 6f |er to Ev|ent Reco|
|000024b0| 72 64 0d 3b 09 6d 6f 76 | 65 2e 77 09 65 76 74 4e |rd.;.mov|e.w.evtN|
|000024c0| 75 6d 28 61 30 29 2c 20 | 64 30 09 09 09 3b 20 47 |um(a0), |d0...; G|
|000024d0| 65 74 20 65 76 65 6e 74 | 20 63 6f 64 65 0d 3b 0d |et event| code.;.|
|000024e0| 3b 09 3b 20 28 65 74 63 | 2e 2e 2e 2e 29 0d 3b 0d |;.; (etc|....).;.|
|000024f0| 3b 09 6d 6f 76 65 2e 77 | 09 64 31 2c 20 28 61 36 |;.move.w|.d1, (a6|
|00002500| 29 09 09 3b 20 53 65 74 | 20 76 61 6c 75 65 20 74 |)..; Set| value t|
|00002510| 6f 20 72 65 74 75 72 6e | 0d 3b 0d 3b 09 52 45 53 |o return|.;.;.RES|
|00002520| 54 4f 52 45 5f 41 4c 4c | 09 09 3b 20 72 65 73 74 |TORE_ALL|..; rest|
|00002530| 6f 72 65 20 72 65 67 69 | 73 74 65 72 73 0d 3b 0d |ore regi|sters.;.|
|00002540| 3b 09 53 54 41 43 4b 5f | 45 4e 44 09 09 3b 20 52 |;.STACK_|END..; R|
|00002550| 65 74 75 72 6e 0d 3b 0d | 0d 3b 20 65 6e 64 20 6f |eturn.;.|.; end o|
|00002560| 66 20 36 38 4b 2d 4d 61 | 63 72 6f 73 0d 0d 00 00 |f 68K-Ma|cros....|
|00002570| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00002580| 00 00 01 00 00 00 01 1d | 00 00 00 1d 00 00 00 c8 |........|........|
|00002590| 4e 56 ff c0 48 ee 60 07 | ff ec 42 2d fc d4 32 2e |NV..H.`.|..B-..2.|
|000025a0| ff f2 48 c1 20 2e ff ec | 24 2e ff f4 4e ba ff b0 |..H. ...|$...N...|
|000025b0| 0e 36 38 4b 2d 4d 61 63 | 72 6f 73 2e 61 73 6d 6f |.68K-Mac|ros.asmo|
|000025c0| 02 00 00 00 54 45 58 54 | 45 44 49 54 01 00 00 14 |....TEXT|EDIT....|
|000025d0| 00 00 54 45 58 54 45 44 | 49 54 01 00 00 14 00 60 |..TEXTED|IT.....`|
|000025e0| 00 00 3b 18 00 00 00 00 | 00 00 00 00 00 00 00 00 |..;.....|........|
|000025f0| 00 00 9f c2 c2 e7 00 00 | 24 ee 00 00 01 e5 4e ba |........|$.....N.|
|00002600| ff 90 2b 48 fc d6 1e 2d | fc d5 67 00 00 d2 20 2d |..+H...-|..g... -|
|00002610| fc d6 4e ad 03 22 2d 40 | ff d8 4a 80 67 00 00 c0 |..N.."-@|..J.g...|
|00002620| 38 2e ff f6 48 c4 20 2e | ff e8 22 2e ff ec 24 2d |8...H. .|.."...$-|
|00002630| fc d6 26 2e ff d8 4e ba | fd ec 2d 40 ff ec 4a 80 |..&...N.|..-@..J.|
|00002640| 6d 00 00 9c 0c 6e 00 03 | ff f2 67 00 00 8c 20 2d |m....n..|..g... -|
|00002650| fc da 4e ba ff 7a 2b 48 | fc da 2e 08 66 00 00 0a |..N..z+H|....f...|
|00002660| 42 ae ff e0 4e fa 00 0e | 20 2d fc da 4e ad 03 22 |B...N...| -..N.."|
|00002670| 2d 40 ff e0 2d 7c 00 00 | 00 01 ff dc 2e 2e ff ec |-@..-|..|........|
|00002680| 00 00 00 11 00 0a 0d 4e | 61 72 72 6f 77 20 4d 6f |.......N|arrow Mo|
|00002690| 6e 61 63 6f 00 00 00 00 | 04 00 05 00 08 00 00 01 |naco....|........|
|000026a0| 00 00 00 01 1d 00 00 00 | 1d 00 00 00 c8 00 05 41 |........|.......A|
|000026b0| 38 08 16 00 00 00 1c 00 | 46 00 01 45 46 4e 54 00 |8.......|F..EFNT.|
|000026c0| 00 00 12 45 54 41 42 00 | 00 00 1e 03 eb 00 00 00 |...ETAB.|........|
|000026d0| 00 00 00 00 05 59 c0 03 | ec 00 41 00 00 00 15 00 |.....Y..|..A.....|
|000026e0| 05 fd 98 40 81 00 00 40 | 80 2a 14 00 1e 1e 08 00 |...@...@|.*......|
|000026f0| 1e 1e 0a 00 1e 1e 0c 00 | 1e 1e 0e 00 1e 1e 10 00 |........|........|
|00002700| 1e 1e 12 00 1e 1e 14 00 | 1e 1e 16 00 1e 1c 96 00 |........|........|
|00002710| 1e 1e 18 00 1e 1e 1a 00 | 1e 1e 1a 00 1e 1e 1a 00 |........|........|
|00002720| 1e 1e 1a 00 40 81 00 00 | 40 80 2a 14 00 1e 1e 08 |....@...|@.*.....|
|00002730| 00 1e 1e 0a 00 1e 1e 0c | 00 1e 1e 0e 00 1e 1e 10 |........|........|
|00002740| 00 1e 1e 12 00 1e 1e 14 | 00 1e 1e 16 00 1e 1c 96 |........|........|
|00002750| 00 1e 1e 18 00 1e 1e 1a | 00 1e 1e 1a 00 1e 1e 1a |........|........|
|00002760| 00 1e 1e 1a 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00002770| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
+--------+-------------------------+-------------------------+--------+--------+